Общие сведения

Touhou Toolkit (коротко — thtk) — это инструмент для распаковки и модификации файлов ресурсов игр серии Touhou. Он позволяет извлекать и изменять игровые спрайты, текстуры, графические элементы интерфейса; внутриигровые тексты; скрипты уровней, задающие движения противников и формулы атак; демо-реплеи и игровые звуки. Он не позволяет работать с музыкой (кроме midi-музыки в 6-8 частях) и файлами сохранений.

Touhou Toolkit включает четыре консольных приложения: thdat обрабатывает базовые dat-файлы игры, остальные три — внутренние файлы, получаемые после их распаковки: thanm — графику, thmsg — диалоги, thecl — скрипты. Он полноценно работает с играми, начиная с шестой части. thdat также может работать с dat-файлами игр для PC-98 (как правило, эти игры хранятся в образах дисков с расширением hdi, но их можно распаковать), но получаемые при распаковке файлы, за исключением текстовых, не обрабатываются thtk. Кроме того, программа может работать и с файлами сторонних игр, имеющих формат, совместимый с форматом какой-либо части Touhou (однако может выдавать необоснованные предупреждения, если формат названий файлов модификации отличается от формата названий файлов соответствующей части Touhou).

Touhou Toolkit является консольным приложением, а данная программа — графическим интерфейсом для него. В первую очередь необходимо указать путь к папке с распакованным thtk. Также можно указать путь, по которому находятся игры. Сам thtk можно скачать с репозитория на Google Code, в его состав также входит справка.

THDAT

Первым этапом работы с thtk является распаковка основного dat-файлы игры. Выберите нужную игру в главном меню (формат dat-файлов менялся от игры к игре), в поле «Папка» укажите папку, в которую его нужно распаковать, в поле «Файл» — адрес нужного dat-файла. Указывайте основной dat-файл, имеющий название формата th№(e|r).dat (кроме шестой части, см. далее), файлы thbgm.dat и score.dat посредством thtk распаковать нельзя. В шестой части игровой контент разделён на шесть дат-файлов, содержащих:

Назначение кнопок:

После распаковки в целевой папке появятся файлы игрового контента. Некоторые из них (например, демо-реплеи, изображения и звуки) можно заменять непосредственно. anm-, ecl- и msg-файлы подлежат дальнейшей распаковке другими программами из состава thtk. Остальные, например, .sht и .std, thtk не обрабатывает.

THANM

Файлы с расширением .anm содержат игровую графику в виде файлов в формате PNG, а также скрипты, описывающие поведение графических элементов. Они распаковываются и собираются аналогично dat-файлам с двумя отличиями:

Утилита также предоставляет возможность заменить одно из изображений в anm-файле, не производя полной пересборки архива. Для этого в строке «Имя» укажите заменяемую позицию (для её выбора воспользуйтесь кнопкой «...» справа от поля ввода), а в строке «Файл» - новую версию изображения, после чего нажмите «Заменить файл в архиве».

THMSG

В msg-файлах хранятся игровые диалоги. Такие файлы могут иметь название формата *.msg (в играх начиная с девятой) или msg*.dat (в 6-8), каждый из них содержит один txt-файл (в кодировке Shift JIS в оригинальных файлах, ASCII в англофицированных). После выбора файла для распаковки программа автоматически сгенерирует имя целевого файла в подпапке /MSG. Кнопка «Выгрузить архив» распаковывает msg-файл в текстовый файл, кнопка «Создать архив» проводит обратную процедуру. Начиная с десятой части, тексты концовок и титров нужно распаковывать со флагом Ending dialogue, этот флаг автоматически проставляется при выборе msg-файлов с соответствующим названием.

THECL

В ecl-файлах хранятся скрипты, задающие движения противников, формулы атак и пр. Их внутреннее устройство и обращение с ними в программе аналогичны описаным выше для msg-файлов. На странице thtk на GoogleCode имеется неполное описание скриптового языка, используемого в этих файлах.

Известные проблемы

Все перечисленные здесь проблемы вызваны самим thtk, а не данным GUI, т.к. воспроизводятся и при прямом использовании консольного thtk.